<!DOCTYPE HTML>
<html lang="en-US" >
    
    <head>
        
        <meta charset="UTF-8">
        <title>测试Actor系统 | AKKA 2.3.6 Scala 文档</title>
        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
        <meta name="description" content="">
        <meta name="generator" content="GitBook 1.0.3">
        <meta name="HandheldFriendly" content="true"/>
        <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
        <meta name="apple-mobile-web-app-capable" content="yes">
        <meta name="apple-mobile-web-app-status-bar-style" content="black">
        <link rel="apple-touch-icon-precomposed" sizes="152x152" href="../gitbook/images/apple-touch-icon-precomposed-152.png">
        <link rel="shortcut icon" href="../gitbook/images/favicon.ico" type="image/x-icon">
        
    
    
    
    <link rel="next" href="../chapter3/09_1_testkit-example.html" />
    
    
    <link rel="prev" href="../chapter3/08_persistence.html" />
    

        
    </head>
    <body>
        
        
<link rel="stylesheet" href="../gitbook/style.css">


        
    <div class="book"  data-level="3.9" data-basepath=".." data-revision="1442802141200">
    

<div class="book-summary">
    <div class="book-search">
        <input type="text" placeholder="Type to search" class="form-control" />
    </div>
    <ul class="summary">
        
    	
    	
    	

        

        
    
        
        <li class="chapter " data-level="0" data-path="index.html">
            
                
                    <a href="../index.html">
                        <i class="fa fa-check"></i>
                        
                         Introduction
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="1" data-path="chapter1/introduction.html">
            
                
                    <a href="../chapter1/introduction.html">
                        <i class="fa fa-check"></i>
                        
                            <b>1.</b>
                        
                         引言
                    </a>
                
            
            
            <ul class="articles">
                
    
        
        <li class="chapter " data-level="1.1" data-path="chapter1/01_what_is_akka.html">
            
                
                    <a href="../chapter1/01_what_is_akka.html">
                        <i class="fa fa-check"></i>
                        
                            <b>1.1.</b>
                        
                         Akka是什么?
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="1.2" data-path="chapter1/02_why_akka.html">
            
                
                    <a href="../chapter1/02_why_akka.html">
                        <i class="fa fa-check"></i>
                        
                            <b>1.2.</b>
                        
                         为什么使用Akka?
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="1.3" data-path="chapter1/03_getting_started.html">
            
                
                    <a href="../chapter1/03_getting_started.html">
                        <i class="fa fa-check"></i>
                        
                            <b>1.3.</b>
                        
                         入门
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="1.4" data-path="chapter1/04_the_obligatory_hello_world.html">
            
                
                    <a href="../chapter1/04_the_obligatory_hello_world.html">
                        <i class="fa fa-check"></i>
                        
                            <b>1.4.</b>
                        
                         必修的“Hello World”
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="1.5" data-path="chapter1/05_usecase_and_deployment_scenarios.html">
            
                
                    <a href="../chapter1/05_usecase_and_deployment_scenarios.html">
                        <i class="fa fa-check"></i>
                        
                            <b>1.5.</b>
                        
                         用例和部署场景
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="1.6" data-path="chapter1/06_examples_of_usecases_for_akka.html">
            
                
                    <a href="../chapter1/06_examples_of_usecases_for_akka.html">
                        <i class="fa fa-check"></i>
                        
                            <b>1.6.</b>
                        
                         Akka使用实例
                    </a>
                
            
            
        </li>
    

            </ul>
            
        </li>
    
        
        <li class="chapter " data-level="2" data-path="chapter2/general.html">
            
                
                    <a href="../chapter2/general.html">
                        <i class="fa fa-check"></i>
                        
                            <b>2.</b>
                        
                         概述
                    </a>
                
            
            
            <ul class="articles">
                
    
        
        <li class="chapter " data-level="2.1" data-path="chapter2/01_terminology_concepts.html">
            
                
                    <a href="../chapter2/01_terminology_concepts.html">
                        <i class="fa fa-check"></i>
                        
                            <b>2.1.</b>
                        
                         术语，概念
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="2.2" data-path="chapter2/02_actor_systems.html">
            
                
                    <a href="../chapter2/02_actor_systems.html">
                        <i class="fa fa-check"></i>
                        
                            <b>2.2.</b>
                        
                         Actor系统
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="2.3" data-path="chapter2/03_what_is_an_actor.html">
            
                
                    <a href="../chapter2/03_what_is_an_actor.html">
                        <i class="fa fa-check"></i>
                        
                            <b>2.3.</b>
                        
                         什么是Actor?
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="2.4" data-path="chapter2/04_supervision_and_monitoring.html">
            
                
                    <a href="../chapter2/04_supervision_and_monitoring.html">
                        <i class="fa fa-check"></i>
                        
                            <b>2.4.</b>
                        
                         监管与监控
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="2.5" data-path="chapter2/05_actor_references_paths_and_addresses.html">
            
                
                    <a href="../chapter2/05_actor_references_paths_and_addresses.html">
                        <i class="fa fa-check"></i>
                        
                            <b>2.5.</b>
                        
                         Actor引用, 路径与地址
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="2.6" data-path="chapter2/06_location_transparency.html">
            
                
                    <a href="../chapter2/06_location_transparency.html">
                        <i class="fa fa-check"></i>
                        
                            <b>2.6.</b>
                        
                         位置透明性
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="2.7" data-path="chapter2/07_akka_and_the_java_memory_model.html">
            
                
                    <a href="../chapter2/07_akka_and_the_java_memory_model.html">
                        <i class="fa fa-check"></i>
                        
                            <b>2.7.</b>
                        
                         Akka与Java内存模型
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="2.8" data-path="chapter2/08_message_delivery_reliability.html">
            
                
                    <a href="../chapter2/08_message_delivery_reliability.html">
                        <i class="fa fa-check"></i>
                        
                            <b>2.8.</b>
                        
                         消息发送语义
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="2.9" data-path="chapter2/09_configuration.html">
            
                
                    <a href="../chapter2/09_configuration.html">
                        <i class="fa fa-check"></i>
                        
                            <b>2.9.</b>
                        
                         配置
                    </a>
                
            
            
        </li>
    

            </ul>
            
        </li>
    
        
        <li class="chapter " data-level="3" data-path="chapter3/actors.html">
            
                
                    <a href="../chapter3/actors.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.</b>
                        
                         Actors
                    </a>
                
            
            
            <ul class="articles">
                
    
        
        <li class="chapter " data-level="3.1" data-path="chapter3/01_actors.html">
            
                
                    <a href="../chapter3/01_actors.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.1.</b>
                        
                         Actors
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="3.2" data-path="chapter3/02_typed_actors.html">
            
                
                    <a href="../chapter3/02_typed_actors.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.2.</b>
                        
                         有类型Actor
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="3.3" data-path="chapter3/03_fault_tolerance.html">
            
                
                    <a href="../chapter3/03_fault_tolerance.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.3.</b>
                        
                         容错
                    </a>
                
            
            
            <ul class="articles">
                
    
        
        <li class="chapter " data-level="3.3.1" data-path="chapter3/03-1_fault_tolerance_sample.html">
            
                
                    <a href="../chapter3/03-1_fault_tolerance_sample.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.3.1.</b>
                        
                         容错示例
                    </a>
                
            
            
        </li>
    

            </ul>
            
        </li>
    
        
        <li class="chapter " data-level="3.4" data-path="chapter3/04_dispatchers.html">
            
                
                    <a href="../chapter3/04_dispatchers.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.4.</b>
                        
                         调度器
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="3.5" data-path="chapter3/05_mailboxes.html">
            
                
                    <a href="../chapter3/05_mailboxes.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.5.</b>
                        
                         邮箱
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="3.6" data-path="chapter3/06_routing.html">
            
                
                    <a href="../chapter3/06_routing.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.6.</b>
                        
                         路由
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="3.7" data-path="chapter3/07_fsm.html">
            
                
                    <a href="../chapter3/07_fsm.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.7.</b>
                        
                         有限状态机(FSM)
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="3.8" data-path="chapter3/08_persistence.html">
            
                
                    <a href="../chapter3/08_persistence.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.8.</b>
                        
                         持久化
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter active" data-level="3.9" data-path="chapter3/09_testing_actor_systems.html">
            
                
                    <a href="../chapter3/09_testing_actor_systems.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.9.</b>
                        
                         测试Actor系统
                    </a>
                
            
            
            <ul class="articles">
                
    
        
        <li class="chapter " data-level="3.9.1" data-path="chapter3/09_1_testkit-example.html">
            
                
                    <a href="../chapter3/09_1_testkit-example.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.9.1.</b>
                        
                         TestKit实例
                    </a>
                
            
            
        </li>
    

            </ul>
            
        </li>
    
        
        <li class="chapter " data-level="3.10" data-path="chapter3/10_actor_dsl.html">
            
                
                    <a href="../chapter3/10_actor_dsl.html">
                        <i class="fa fa-check"></i>
                        
                            <b>3.10.</b>
                        
                         Actor DSL
                    </a>
                
            
            
        </li>
    

            </ul>
            
        </li>
    
        
        <li class="chapter " data-level="4" data-path="chapter4/futures_and_agents.html">
            
                
                    <a href="../chapter4/futures_and_agents.html">
                        <i class="fa fa-check"></i>
                        
                            <b>4.</b>
                        
                         Futures与Agents
                    </a>
                
            
            
            <ul class="articles">
                
    
        
        <li class="chapter " data-level="4.1" data-path="chapter4/01_futures.html">
            
                
                    <a href="../chapter4/01_futures.html">
                        <i class="fa fa-check"></i>
                        
                            <b>4.1.</b>
                        
                         Futures
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="4.2" data-path="chapter4/02_agents.html">
            
                
                    <a href="../chapter4/02_agents.html">
                        <i class="fa fa-check"></i>
                        
                            <b>4.2.</b>
                        
                         Agents
                    </a>
                
            
            
        </li>
    

            </ul>
            
        </li>
    
        
        <li class="chapter " data-level="5" data-path="chapter5/networking.html">
            
                
                    <a href="../chapter5/networking.html">
                        <i class="fa fa-check"></i>
                        
                            <b>5.</b>
                        
                         网络
                    </a>
                
            
            
            <ul class="articles">
                
    
        
        <li class="chapter " data-level="5.1" data-path="chapter5/01_cluster_cpecification.html">
            
                
                    <a href="../chapter5/01_cluster_cpecification.html">
                        <i class="fa fa-check"></i>
                        
                            <b>5.1.</b>
                        
                         集群规格
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="5.2" data-path="chapter5/02_cluster_usage.html">
            
                
                    <a href="../chapter5/02_cluster_usage.html">
                        <i class="fa fa-check"></i>
                        
                            <b>5.2.</b>
                        
                         集群用法
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="5.3" data-path="chapter5/03_remoting.html">
            
                
                    <a href="../chapter5/03_remoting.html">
                        <i class="fa fa-check"></i>
                        
                            <b>5.3.</b>
                        
                         远程
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="5.4" data-path="chapter5/04_serialization.html">
            
                
                    <a href="../chapter5/04_serialization.html">
                        <i class="fa fa-check"></i>
                        
                            <b>5.4.</b>
                        
                         序列化
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="5.5" data-path="chapter5/05_io.html">
            
                
                    <a href="../chapter5/05_io.html">
                        <i class="fa fa-check"></i>
                        
                            <b>5.5.</b>
                        
                         I/O
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="5.6" data-path="chapter5/06_using_tcp.html">
            
                
                    <a href="../chapter5/06_using_tcp.html">
                        <i class="fa fa-check"></i>
                        
                            <b>5.6.</b>
                        
                         使用TCP
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="5.7" data-path="chapter5/07_using_udp.html">
            
                
                    <a href="../chapter5/07_using_udp.html">
                        <i class="fa fa-check"></i>
                        
                            <b>5.7.</b>
                        
                         使用UDP
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="5.8" data-path="chapter5/08_zeromq.html">
            
                
                    <a href="../chapter5/08_zeromq.html">
                        <i class="fa fa-check"></i>
                        
                            <b>5.8.</b>
                        
                         ZeroMQ
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="5.9" data-path="chapter5/09_camel.html">
            
                
                    <a href="../chapter5/09_camel.html">
                        <i class="fa fa-check"></i>
                        
                            <b>5.9.</b>
                        
                         Camel
                    </a>
                
            
            
        </li>
    

            </ul>
            
        </li>
    
        
        <li class="chapter " data-level="6" data-path="chapter6/utilities.html">
            
                
                    <a href="../chapter6/utilities.html">
                        <i class="fa fa-check"></i>
                        
                            <b>6.</b>
                        
                         实用工具
                    </a>
                
            
            
            <ul class="articles">
                
    
        
        <li class="chapter " data-level="6.1" data-path="chapter6/01_event_bus.html">
            
                
                    <a href="../chapter6/01_event_bus.html">
                        <i class="fa fa-check"></i>
                        
                            <b>6.1.</b>
                        
                         事件总线
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="6.2" data-path="chapter6/02_logging.html">
            
                
                    <a href="../chapter6/02_logging.html">
                        <i class="fa fa-check"></i>
                        
                            <b>6.2.</b>
                        
                         日志
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="6.3" data-path="chapter6/03_scheduler.html">
            
                
                    <a href="../chapter6/03_scheduler.html">
                        <i class="fa fa-check"></i>
                        
                            <b>6.3.</b>
                        
                         调度器
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="6.4" data-path="chapter6/04_duration.html">
            
                
                    <a href="../chapter6/04_duration.html">
                        <i class="fa fa-check"></i>
                        
                            <b>6.4.</b>
                        
                         Duration
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="6.5" data-path="chapter6/05_circuit_breaker.html">
            
                
                    <a href="../chapter6/05_circuit_breaker.html">
                        <i class="fa fa-check"></i>
                        
                            <b>6.5.</b>
                        
                         线路断路器
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="6.6" data-path="chapter6/06_akka_extensions.html">
            
                
                    <a href="../chapter6/06_akka_extensions.html">
                        <i class="fa fa-check"></i>
                        
                            <b>6.6.</b>
                        
                         Akka扩展
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="6.7" data-path="chapter6/07_microkernel.html">
            
                
                    <a href="../chapter6/07_microkernel.html">
                        <i class="fa fa-check"></i>
                        
                            <b>6.7.</b>
                        
                         微内核
                    </a>
                
            
            
        </li>
    

            </ul>
            
        </li>
    
        
        <li class="chapter " data-level="7" data-path="chapter7/howto_common_patterns.html">
            
                
                    <a href="../chapter7/howto_common_patterns.html">
                        <i class="fa fa-check"></i>
                        
                            <b>7.</b>
                        
                         如何使用：常用模式
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="8" data-path="chapter8/experimental_modules.html">
            
                
                    <a href="../chapter8/experimental_modules.html">
                        <i class="fa fa-check"></i>
                        
                            <b>8.</b>
                        
                         实验模块
                    </a>
                
            
            
            <ul class="articles">
                
    
        
        <li class="chapter " data-level="8.1" data-path="chapter3/08_persistence.html">
            
                
                    <a href="../chapter3/08_persistence.html">
                        <i class="fa fa-check"></i>
                        
                            <b>8.1.</b>
                        
                         持久化
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="8.2" data-path="chapter8/02_multi_node_testing.html">
            
                
                    <a href="../chapter8/02_multi_node_testing.html">
                        <i class="fa fa-check"></i>
                        
                            <b>8.2.</b>
                        
                         多节点测试
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="8.3" data-path="chapter8/03_actors.html">
            
                
                    <a href="../chapter8/03_actors.html">
                        <i class="fa fa-check"></i>
                        
                            <b>8.3.</b>
                        
                         Actors(使用Java的Lambda支持)
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="8.4" data-path="chapter8/04_fsm.html">
            
                
                    <a href="../chapter8/04_fsm.html">
                        <i class="fa fa-check"></i>
                        
                            <b>8.4.</b>
                        
                         FSM(使用Java的Lambda支持)
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="8.5" data-path="chapter8/05_external_contributions.html">
            
                
                    <a href="../chapter8/05_external_contributions.html">
                        <i class="fa fa-check"></i>
                        
                            <b>8.5.</b>
                        
                         外部贡献
                    </a>
                
            
            
        </li>
    

            </ul>
            
        </li>
    
        
        <li class="chapter " data-level="9" data-path="chapter9/information_for_akka_developers.html">
            
                
                    <a href="../chapter9/information_for_akka_developers.html">
                        <i class="fa fa-check"></i>
                        
                            <b>9.</b>
                        
                         Akka开发者信息
                    </a>
                
            
            
            <ul class="articles">
                
    
        
        <li class="chapter " data-level="9.1" data-path="chapter9/01_building_akka.html">
            
                
                    <a href="../chapter9/01_building_akka.html">
                        <i class="fa fa-check"></i>
                        
                            <b>9.1.</b>
                        
                         构建Akka
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="9.2" data-path="chapter9/02_multi_jvm_testing.html">
            
                
                    <a href="../chapter9/02_multi_jvm_testing.html">
                        <i class="fa fa-check"></i>
                        
                            <b>9.2.</b>
                        
                         多JVM测试
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="9.3" data-path="chapter9/03_io_layer_design.html">
            
                
                    <a href="../chapter9/03_io_layer_design.html">
                        <i class="fa fa-check"></i>
                        
                            <b>9.3.</b>
                        
                         I/O层设计
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="9.4" data-path="chapter9/04_developer_guidelines.html">
            
                
                    <a href="../chapter9/04_developer_guidelines.html">
                        <i class="fa fa-check"></i>
                        
                            <b>9.4.</b>
                        
                         开发指南
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="9.5" data-path="chapter9/05_documentation_guidelines.html">
            
                
                    <a href="../chapter9/05_documentation_guidelines.html">
                        <i class="fa fa-check"></i>
                        
                            <b>9.5.</b>
                        
                         文档指南
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="9.6" data-path="chapter9/06_team.html">
            
                
                    <a href="../chapter9/06_team.html">
                        <i class="fa fa-check"></i>
                        
                            <b>9.6.</b>
                        
                         团队
                    </a>
                
            
            
        </li>
    

            </ul>
            
        </li>
    
        
        <li class="chapter " data-level="10" data-path="chapter10/project_information.html">
            
                
                    <a href="../chapter10/project_information.html">
                        <i class="fa fa-check"></i>
                        
                            <b>10.</b>
                        
                         工程信息
                    </a>
                
            
            
            <ul class="articles">
                
    
        
        <li class="chapter " data-level="10.1" data-path="chapter10/01_migration_guides.html">
            
                
                    <a href="../chapter10/01_migration_guides.html">
                        <i class="fa fa-check"></i>
                        
                            <b>10.1.</b>
                        
                         迁移指南
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="10.2" data-path="chapter10/02_issue_tracking.html">
            
                
                    <a href="../chapter10/02_issue_tracking.html">
                        <i class="fa fa-check"></i>
                        
                            <b>10.2.</b>
                        
                         问题追踪
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="10.3" data-path="chapter10/03_licenses.html">
            
                
                    <a href="../chapter10/03_licenses.html">
                        <i class="fa fa-check"></i>
                        
                            <b>10.3.</b>
                        
                         许可证
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="10.4" data-path="chapter10/04_sponsors.html">
            
                
                    <a href="../chapter10/04_sponsors.html">
                        <i class="fa fa-check"></i>
                        
                            <b>10.4.</b>
                        
                         赞助商
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="10.5" data-path="chapter10/05_project.html">
            
                
                    <a href="../chapter10/05_project.html">
                        <i class="fa fa-check"></i>
                        
                            <b>10.5.</b>
                        
                         项目
                    </a>
                
            
            
        </li>
    

            </ul>
            
        </li>
    
        
        <li class="chapter " data-level="11" data-path="chapter11/additional_information.html">
            
                
                    <a href="../chapter11/additional_information.html">
                        <i class="fa fa-check"></i>
                        
                            <b>11.</b>
                        
                         附加信息
                    </a>
                
            
            
            <ul class="articles">
                
    
        
        <li class="chapter " data-level="11.1" data-path="chapter11/01_faq.html">
            
                
                    <a href="../chapter11/01_faq.html">
                        <i class="fa fa-check"></i>
                        
                            <b>11.1.</b>
                        
                         常见问题
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="11.2" data-path="chapter11/02_books.html">
            
                
                    <a href="../chapter11/02_books.html">
                        <i class="fa fa-check"></i>
                        
                            <b>11.2.</b>
                        
                         图书
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="11.3" data-path="chapter11/03_other_language_bindings.html">
            
                
                    <a href="../chapter11/03_other_language_bindings.html">
                        <i class="fa fa-check"></i>
                        
                            <b>11.3.</b>
                        
                         其他语言绑定
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="11.4" data-path="chapter11/04_akka_in_osgi.html">
            
                
                    <a href="../chapter11/04_akka_in_osgi.html">
                        <i class="fa fa-check"></i>
                        
                            <b>11.4.</b>
                        
                         Akka与OSGi
                    </a>
                
            
            
        </li>
    
        
        <li class="chapter " data-level="11.5" data-path="chapter11/05_incomplete_list_of_http_frameworks.html">
            
                
                    <a href="../chapter11/05_incomplete_list_of_http_frameworks.html">
                        <i class="fa fa-check"></i>
                        
                            <b>11.5.</b>
                        
                         部分HTTP框架名单
                    </a>
                
            
            
        </li>
    

            </ul>
            
        </li>
    


        
        <li class="divider"></li>
        <li>
            <a href="http://www.gitbook.io/" target="blank" class="gitbook-link">Published using GitBook</a>
        </li>
        
    </ul>
</div>

    <div class="book-body">
        <div class="body-inner">
            <div class="book-header">
    <!-- Actions Left -->
    <a href="#" class="btn pull-left toggle-summary" aria-label="Toggle summary"><i class="fa fa-align-justify"></i></a>
    <a href="#" class="btn pull-left toggle-search" aria-label="Toggle search"><i class="fa fa-search"></i></a>
    
    <div id="font-settings-wrapper" class="dropdown pull-left">
        <a href="#" class="btn toggle-dropdown" aria-label="Toggle font settings"><i class="fa fa-font"></i>
        </a>
        <div class="dropdown-menu font-settings">
    <div class="dropdown-caret">
        <span class="caret-outer"></span>
        <span class="caret-inner"></span>
    </div>

    <div class="buttons">
        <button type="button" id="reduce-font-size" class="button size-2">A</button>
        <button type="button" id="enlarge-font-size" class="button size-2">A</button>
    </div>

    <div class="buttons font-family-list">
        <button type="button" data-font="0" class="button">Serif</button>
        <button type="button" data-font="1" class="button">Sans</button>
    </div>

    <div class="buttons color-theme-list">
        <button type="button" id="color-theme-preview-0" class="button size-3" data-theme="0">White</button>
        <button type="button" id="color-theme-preview-1" class="button size-3" data-theme="1">Sepia</button>
        <button type="button" id="color-theme-preview-2" class="button size-3" data-theme="2">Night</button>
    </div>
</div>

    </div>

    <!-- Actions Right -->
    
    <div class="dropdown pull-right">
        <a href="#" class="btn toggle-dropdown" aria-label="Toggle share dropdown"><i class="fa fa-share-alt"></i>
        </a>
        <div class="dropdown-menu font-settings dropdown-left">
            <div class="dropdown-caret">
                <span class="caret-outer"></span>
                <span class="caret-inner"></span>
            </div>
            <div class="buttons">
                <button type="button" data-sharing="twitter" class="button">Twitter</button>
                <button type="button" data-sharing="google-plus" class="button">Google</button>
                <button type="button" data-sharing="facebook" class="button">Facebook</button>
                <button type="button" data-sharing="weibo" class="button">Weibo</button>
                <button type="button" data-sharing="instapaper" class="button">Instapaper</button>
            </div>
        </div>
    </div>
    

    
    <a href="#" target="_blank" class="btn pull-right google-plus-sharing-link sharing-link" data-sharing="google-plus" aria-label="Share on Google Plus"><i class="fa fa-google-plus"></i></a>
    
    
    <a href="#" target="_blank" class="btn pull-right facebook-sharing-link sharing-link" data-sharing="facebook" aria-label="Share on Facebook"><i class="fa fa-facebook"></i></a>
    
    
    <a href="#" target="_blank" class="btn pull-right twitter-sharing-link sharing-link" data-sharing="twitter" aria-label="Share on Twitter"><i class="fa fa-twitter"></i></a>
    
    

    <!-- Title -->
    <h1>
        <i class="fa fa-circle-o-notch fa-spin"></i>
        <a href="../" >AKKA 2.3.6 Scala 文档</a>
    </h1>
</div>

            <div class="page-wrapper" tabindex="-1">
                <div class="page-inner">
                
                
                    <section class="normal" id="section-gitbook_90">
                    
                        <h1 id="actor">测试Actor系统</h1>
<ul>
<li><a href="09_1_testkit-example.html">TestKit 实例 (Scala)</a></li>
</ul>
<p>对于任何软件开发，自动化测试都是开发过程中一个重要组成部分。actor 模型对于代码单元如何划分，它们之间如何交互提供了一种新的视角，这对如何编写测试也造成了影响。</p>
<p>Akka 有一个专门的模块——<code>akka-testkit</code>来支持不同层次上的测试，测试很明显有两个类别：</p>
<ul>
<li>测试独立的、不包括actor模型的代码，即没有多线程的内容；这意味着给事件发生的次序给定，有完全确定的行为，没有任何并发考虑，这在下文中称为 <strong>单元测试（Unit Testing）</strong>。</li>
<li>测试（多个）包装过的actor，包括多线程调度；这意味着事件的次序没有确定性，但由于使用了actor模型而不需要考虑并发，这在下文中被称为 <strong>集成测试（Integration Testing）</strong>。</li>
</ul>
<p>当然这两个类型有着不同的测试粒度，单元测试通常是白盒测试，而集成测试是对完整的actor网络进行的功能测试。是否把并发考虑为测试的一部分，是其中重要的区别。我们提供的工具将在下面的章节中详细介绍。</p>
<blockquote>
<p>注意</p>
<p>请确保在依赖项中加入<code>akka-testkit</code>模块。</p>
</blockquote>
<h3 id="testactorref">用<code>TestActorRef</code>做同步单元测试</h3>
<p><code>Actor</code>类中的业务逻辑测试可以分为两部分：首先，每个原子操作必须独立工作，然后输入的事件序列必须被正确处理，即使事件的次序存在一些可能的变化。前者是单线程单元测试的主要使用场景，而后者可以在集成测试中进行确认。</p>
<p>通常，<code>ActorRef</code>将实际的<code>Actor</code>实例与外界隔离开，唯一的通信通道是actor的邮箱。这个限制是单元测试的障碍，所以我们引入了<code>TestActorRef</code>。这个特殊类型的引用是专门为测试而设计的，它允许以两种方式访问actor：通过获取实际actor实例的引用，或者通过调用或查询actor的行为（<code>receive</code>）。下文中对每一种方式都有专门的章节介绍。</p>
<h5 id="actor">获取一个<code>Actor</code>的引用</h5>
<p>能够访问到实际的<code>Actor</code>对象使得所有的传统单元测试技术都可以用于测试其中的方法。可以像这样获取一个引用：</p>
<pre><code class="lang-scala"><span class="hljs-keyword">import</span> akka.testkit.<span class="hljs-type">TestActorRef</span>

<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">actorRef</span> =</span> <span class="hljs-type">TestActorRef</span>[<span class="hljs-type">MyActor</span>]
<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">actor</span> =</span> actorRef.underlyingActor
</code></pre>
<p>由于<code>TestActorRef</code>是actor类型的高阶类型（泛型），因此它返回的底层actor具有正确的静态类型。这样以后你就可以象平常一样将任何单元测试工具用于actor上了。</p>
<h5 id="a-nametestfsmrefa"><a name="testfsmref"></a>测试有限状态机</h5>
<p>如果你要测试的actor是一个<code>FSM</code>，你可以使用专门的<code>TestFSMRef</code>，它拥有普通<code>TestActorRef</code>的所有功能，并且额外地允许访问其内部状态：</p>
<pre><code class="lang-scala"><span class="hljs-keyword">import</span> akka.testkit.<span class="hljs-type">TestFSMRef</span>
<span class="hljs-keyword">import</span> akka.actor.<span class="hljs-type">FSM</span>
<span class="hljs-keyword">import</span> scala.concurrent.duration._

<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">fsm</span> =</span> <span class="hljs-type">TestFSMRef</span>(<span class="hljs-keyword">new</span> <span class="hljs-type">TestFsmActor</span>)

<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">mustBeTypedProperly</span>:</span> <span class="hljs-type">TestActorRef</span>[<span class="hljs-type">TestFsmActor</span>] = fsm

assert(fsm.stateName == <span class="hljs-number">1</span>)
assert(fsm.stateData == <span class="hljs-string">""</span>)
fsm ! <span class="hljs-string">"go"</span> <span class="hljs-comment">// being a TestActorRef, this runs also on the CallingThreadDispatcher</span>
assert(fsm.stateName == <span class="hljs-number">2</span>)
assert(fsm.stateData == <span class="hljs-string">"go"</span>)

fsm.setState(stateName = <span class="hljs-number">1</span>)
assert(fsm.stateName == <span class="hljs-number">1</span>)

assert(fsm.isTimerActive(<span class="hljs-string">"test"</span>) == <span class="hljs-literal">false</span>)
fsm.setTimer(<span class="hljs-string">"test"</span>, <span class="hljs-number">12</span>, <span class="hljs-number">10</span> millis, <span class="hljs-literal">true</span>)
assert(fsm.isTimerActive(<span class="hljs-string">"test"</span>) == <span class="hljs-literal">true</span>)
fsm.cancelTimer(<span class="hljs-string">"test"</span>)
assert(fsm.isTimerActive(<span class="hljs-string">"test"</span>) == <span class="hljs-literal">false</span>)
</code></pre>
<p>由于Scala类型推断的限制，只有一个如上所示的工厂方法，所以你很可能需要写像<code>TestFSMRef(new MyFSM)</code>这样的代码，而不是想象中的类似<code>ActorRef</code>的<code>TestFSMRef[MyFSM]</code>。上例所示的所有方法都直接访问FSM的状态，不作任何同步；这在使用<code>CallingThreadDispatcher</code>且没有其它线程参与的情况下是合适的，但如果你实际上需要处理定时器事件可能会导致意外的情形，因为它们是在<code>Scheduler</code>线程中执行的。</p>
<h5 id="actor">测试Actor的行为</h5>
<p>当消息派发器调用actor的逻辑来处理一条消息时，它实际上是对当前注册到actor的行为调用了<code>apply</code>。行为的初始值是代码中声明的<code>receive</code>方法的返回值，但可以通过对外部消息的响应调用<code>become</code>和<code>unbecome</code>来改变这个行为。所有这些特性使得进行actor的行为测试不太容易。因此<code>TestActorRef</code>提供了一种不同的操作方式来对<code>Actor</code>的测试进行补充：它支持所有正常的<code>ActorRef</code>中的操作。发往actor的消息在当前线程中同步处理，应答象往常一样回送。这个技巧来自下面所介绍的<a href="#CallingThreadDispatcher"><code>CallingThreadDispatcher</code></a>；这个派发器被隐式地用于所有实例化为<code>TestActorRef</code>的actor。</p>
<pre><code class="lang-scala"><span class="hljs-keyword">import</span> akka.testkit.<span class="hljs-type">TestActorRef</span>
<span class="hljs-keyword">import</span> scala.concurrent.duration._
<span class="hljs-keyword">import</span> scala.concurrent.<span class="hljs-type">Await</span>
<span class="hljs-keyword">import</span> akka.pattern.ask

<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">actorRef</span> =</span> <span class="hljs-type">TestActorRef</span>(<span class="hljs-keyword">new</span> <span class="hljs-type">MyActor</span>)
<span class="hljs-comment">// hypothetical message stimulating a '42' answer</span>
<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">future</span> =</span> actorRef ? <span class="hljs-type">Say42</span>
<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">Success</span>(</span>result: <span class="hljs-type">Int</span>) = future.value.get
result should be(<span class="hljs-number">42</span>)
</code></pre>
<p>由于<code>TestActorRef</code>是<code>LocalActorRef</code>的子类，只是附加了一些特殊功能，所以像监管和重启这样的功能也能正常工作，但要注意：只要所有相关的actor都使用<code>CallingThreadDispatcher</code>，那么所有的执行过程都是严格同步的。一旦你增加了一些元素，其中包括比较复杂的定时任务，你就离开了单元测试的范畴，因为你必须要重新将异步性纳入考虑范围（在大多数情况下问题在于要等待希望的结果有机会发生）。</p>
<p>另一个在单线程测试中被覆盖的特殊点是<code>receiveTimeout</code>，由于包含了它会产生异步的<code>ReceiveTimeout</code>消息队列，因此与同步约定矛盾。</p>
<blockquote>
<p>警告</p>
<p>综上所述：<code>TestActorRef</code>重写了两个成员：它设置派发器为<code>CallingThreadDispatcher.global</code>，设置<code>receiveTimeout</code>为None。</p>
</blockquote>
<h5 id="">介于两者之间方法：期望异常</h5>
<p>如果你想要测试actor的行为，包括热替换，但是不涉及消息派发器，也不希望<code>TestActorRef</code>吞掉所有抛出的异常，那么为你准备了另一种模式：只要使用 <code>TestActorRef</code> 的 <code>receive</code> 方法 ，这将会把消息转发给内部的 actor:</p>
<pre><code class="lang-scala"><span class="hljs-keyword">import</span> akka.testkit.<span class="hljs-type">TestActorRef</span>

<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">actorRef</span> =</span> <span class="hljs-type">TestActorRef</span>(<span class="hljs-keyword">new</span> <span class="hljs-type">Actor</span> {
  <span class="hljs-function"><span class="hljs-keyword">def</span> <span class="hljs-title">receive</span> =</span> {
    <span class="hljs-keyword">case</span> <span class="hljs-string">"hello"</span> =&gt; <span class="hljs-keyword">throw</span> <span class="hljs-keyword">new</span> <span class="hljs-type">IllegalArgumentException</span>(<span class="hljs-string">"boom"</span>)
  }
})
intercept[<span class="hljs-type">IllegalArgumentException</span>] { actorRef.receive(<span class="hljs-string">"hello"</span>) }
</code></pre>
<h5 id="">使用场景</h5>
<p>当然你可以根据自己的测试需求来混合使用 <code>TestActorRef</code> 的不同用法:</p>
<ul>
<li>一个常见的使用场景是在发送测试消息之前设置actor进入某个特定的内部状态</li>
<li>另一个场景是发送了测试消息之后验证内部状态转换的正确性</li>
</ul>
<p>放心大胆地对各种可能性进行实验，如果你发现了有用的模式，快让Akka论坛知道它！常用操作甚至可能放进优美的DSL中，谁知道呢。</p>
<h3 id="testkit">用<code>TestKit</code>进行异步集成测试</h3>
<p>当基本确定你的actor的业务逻辑是正确的之后，下一步就是确认它在目标环境中也能正确工作（如果actor个体都足够简单，可能是因为他们使用了 <code>FSM</code> 模块，这也可以放到第一步)。关于环境的定义当然很大程度上由手头的问题和你打算测试的程度来决定，从功能/集成测试到完整的系统测试。最简单的步骤包括测试过程（提供所期望的触发条件）、要测试的actor和接收应答的actor。大一些的系统将被测的actor替换成一组actor网络，将触发条件应用于不同的切入点，并整理将会从不同的输出位置发送的结果，但基本的原则保持不变，就是测试由一个单独的流程来驱动。</p>
<p><code>TestKit</code> 类包含一组工具来简化这些常用的工作.</p>
<pre><code class="lang-scala"><span class="hljs-keyword">import</span> akka.actor.<span class="hljs-type">ActorSystem</span>
<span class="hljs-keyword">import</span> akka.actor.<span class="hljs-type">Actor</span>
<span class="hljs-keyword">import</span> akka.actor.<span class="hljs-type">Props</span>
<span class="hljs-keyword">import</span> akka.testkit.{ <span class="hljs-type">TestActors</span>, <span class="hljs-type">TestKit</span>, <span class="hljs-type">ImplicitSender</span> }
<span class="hljs-keyword">import</span> org.scalatest.<span class="hljs-type">WordSpecLike</span>
<span class="hljs-keyword">import</span> org.scalatest.<span class="hljs-type">Matchers</span>
<span class="hljs-keyword">import</span> org.scalatest.<span class="hljs-type">BeforeAndAfterAll</span>

<span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">MySpec</span>(</span>_system: <span class="hljs-type">ActorSystem</span>) <span class="hljs-keyword">extends</span> <span class="hljs-type">TestKit</span>(_system) <span class="hljs-keyword">with</span> <span class="hljs-type">ImplicitSender</span>
  <span class="hljs-keyword">with</span> <span class="hljs-type">WordSpecLike</span> <span class="hljs-keyword">with</span> <span class="hljs-type">Matchers</span> <span class="hljs-keyword">with</span> <span class="hljs-type">BeforeAndAfterAll</span> {

  <span class="hljs-function"><span class="hljs-keyword">def</span> <span class="hljs-title">this</span>(</span>) = <span class="hljs-keyword">this</span>(<span class="hljs-type">ActorSystem</span>(<span class="hljs-string">"MySpec"</span>))

  <span class="hljs-keyword">override</span> <span class="hljs-function"><span class="hljs-keyword">def</span> <span class="hljs-title">afterAll</span> {</span>
    <span class="hljs-type">TestKit</span>.shutdownActorSystem(system)
  }

  <span class="hljs-string">"An Echo actor"</span> must {

    <span class="hljs-string">"send back messages unchanged"</span> in {
      <span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">echo</span> =</span> system.actorOf(<span class="hljs-type">TestActors</span>.echoActorProps)
      echo ! <span class="hljs-string">"hello world"</span>
      expectMsg(<span class="hljs-string">"hello world"</span>)
    }

  }
}
</code></pre>
<p><code>TestKit</code> 中有一个名为 <code>testActor</code> 的actor作为将要被不同的 <code>expectMsg...</code>断言检查的消息的入口，下面会详细介绍这些断言。 当混入了 <code>ImplicitSender</code> trait后，这个测试actor会在整个测试过程中，被隐式地用作消息的发送者引用。<code>testActor</code> 也可以像平常一样被发送给其它的actor，通常是订阅成为通知监听器。有一套检查方法，例如 接收所有匹配某些条件的消息，接收一系列固定的消息序列或类，在某段时间内收不到消息，等。</p>
<p>作为参数传递到<code>TestKit</code>构造函数的<code>ActorSystem</code>可以通过<code>system</code>成员来访问。记得在测试完成后关闭actor系统 (即使是在测试失败的情况下) 以保证所有的actor——包括测试actor——被停止.</p>
<h5 id="">内置断言</h5>
<p>上面提到的 <code>expectMsg</code>并不是唯一的对收到的消息进行断言的方法。以下是完整的列表:</p>
<ul>
<li><p><code>expectMsg[T](d: Duration, msg: T): T</code></p>
<p>给定的消息对象必须在指定的时间内到达；该消息对象将被返回。</p>
</li>
<li><p><code>expectMsgPF[T](d: Duration)(pf: PartialFunction[Any, T]): T</code></p>
<p>在给定的时间段内，必须有一条消息到达，必须为这类消息定义了偏函数；将收到的消息应用于偏函数并返回其结果。可以不指定时间段（这时需要一对空的括号），这时使用最深层的 <a href="#testkit-within"><code>within</code></a> 块中的期限。</p>
</li>
<li><p><code>expectMsgClass[T](d: Duration, c: Class[T]): T</code></p>
<p>在分配的时间片内必须接收到<code>Class</code>类型的对象实例；并返回该对象。注意它的类型匹配是子类兼容的；如果需要类型是相等的，参考使用单个class参数的<code>expectMsgAllClassOf</code>。</p>
</li>
<li><p><code>expectMsgType[T: Manifest](d: Duration)</code></p>
<p>在分配的时间片内必须收到指定类型 (擦除后)的对象实例；并返回该对象。这个方法基本上与 <code>expectMsgClass(implicitly[ClassTag[T]].runtimeClass)</code>等价。</p>
</li>
<li><p><code>expectMsgAnyOf[T](d: Duration, obj: T*): T</code></p>
<p>在指定的时间内必须收到一个对象，而且此对象必须与传入的多个对象引用中至少一个相等( 用 <code>==</code> 进行比较)；并返回该对象。</p>
</li>
<li><p><code>expectMsgAnyClassOf[T](d: Duration, obj: Class[_ &lt;: T]*): T</code></p>
<p>在指定的时间内必须收到一个对象，它必须指定的多个<code>Class</code>中某一个类对象的实例；并返回该对象。</p>
</li>
<li><p><code>expectMsgAllOf[T](d: Duration, obj: T*): Seq[T]</code></p>
<p>在指定时间内必须收到与指定的对象数组中相等数量的对象，对每个收到的对象，必须至少有一个数组中的对象与之相等(用<code>==</code>进行比较) 。返回收到对象的完整序列。</p>
</li>
<li><p><code>expectMsgAllClassOf[T](d: Duration, c: Class[_ &lt;: T]*): Seq[T]</code></p>
<p>在指定时间内必须收到与指定的 <code>Class</code> 数组相等数量的对象，对数组中的每一个类，必须至少有一个对象的类与之相等(用 <code>==</code>进行比较) (这 <em>不是</em> 子类兼容的类型检查)。返回收到对象的完整序列。</p>
</li>
<li><p><code>expectMsgAllConformingOf[T](d: Duration, c: Class[_ &lt;: T]*): Seq[T]</code></p>
<p>在指定时间内必须收到与指定的 <code>Class</code>数组相等数量的对象，对数组中的每个类必须至少有一个对象是这个类的实例。返回收到对象的完整序列。</p>
</li>
<li><p><code>expectNoMsg(d: Duration)</code></p>
<p>在指定时间内不能收到消息。如果在这个方法被调用之前已经收到了消息，并且没有用其它的方法将这些消息从队列中删除，这个断言也会失败。</p>
</li>
<li><p><code>receiveN(n: Int, d: Duration): Seq[AnyRef]</code></p>
<p>指定的时间内必须收到<code>n</code>条消息；返回收到的消息。</p>
</li>
<li><p><code>fishForMessage(max: Duration, hint: String)(pf: PartialFunction[Any, Boolean]): Any</code></p>
<p>只要时间没有用完，而且偏函数匹配收到的消息并返回<code>false</code>，则一直接收消息。返回使偏函数返回<code>true</code> 的消息或抛出异常，异常中会提供一些提示供debug使用。</p>
</li>
</ul>
<p>除了消息接收断言，还有一些方法来对消息流提供帮助：</p>
<ul>
<li><p><code>receiveOne(d: Duration): AnyRef</code></p>
<p>尝试等待给定的时间间隔来接收一个消息，如果失败则返回<code>null</code>。如果给定的<code>Duration</code>是0，则调用是非阻塞的（轮询模式）。</p>
</li>
<li><p><code>receiveWhile[T](max: Duration, idle: Duration, messages: Int)(pf: PartialFunction[Any, T]): Seq[T]</code></p>
<p>只要满足以下条件就收集消息：</p>
<ul>
<li>消息与偏函数匹配</li>
<li>指定的时间还没用完</li>
<li>在空闲的时间内收到了下一条消息</li>
<li>消息数量还没有到上限</li>
</ul>
<p>返回收集到的所有消息。时间上限缺省值是最深层的 <a href="#testkit-within"><code>within</code></a> 块中的剩余时间，空闲时间缺省为无限 (也就是禁止空闲超时功能)。期望的消息数量缺省值为 Int.MaxValue，也就是不作这个限制。</p>
</li>
<li><p><code>awaitCond(p: =&gt; Boolean, max: Duration, interval: Duration)</code></p>
<p>每经过 <code>interval</code>时间就检查一下给定的条件，直到它返回 <code>true</code> 或者 <code>max</code> 时间用完了。时间间隔缺省为 100 ms 而最大值缺省为最深层的 <a href="#testkit-within"><code>within</code></a>  块中的剩余时间。</p>
</li>
<li><p><code>awaitAssert(a: =&gt; Any, max: Duration, interval: Duration)</code></p>
<p>在每个时间间隔验证一遍给定的断言函数，直到它不抛出异常，或<code>max</code>持续时间用完。如果在超时已到则抛出最后一个异常。间隔默认为 100 ms 和最大值默认为最深层的 <a href="#testkit-within"><code>within</code></a>  块中的剩余时间。
TODO Akka文档中的重复</p>
</li>
<li><p><code>ignoreMsg(pf: PartialFunction[AnyRef, Boolean])</code>
<code>ignoreNoMsg</code></p>
<p>内部的 <code>testActor</code> 包含一个偏函数用来忽略消息：它只会将与偏函数不匹配或使函数返回<code>false</code>的消息放进队列。 这个函数可以用上面的方法进行设置和重设；每一次调用都会覆盖之前的函数，而不会迭加。</p>
<p>这个功能在你想忽略一般的消息而只对指定的一些消息感兴趣时（例如测试日志系统时）比较有用。</p>
</li>
</ul>
<h5 id="">期望日志消息</h5>
<p>由于集成测试不允许进入参与测试的actor内部处理流程，无法直接确认预料中的异常。因此为了做这件事，只能使用日志系统：将普通的事件处理器替换成 <code>TestEventListener</code>并使用一个 <code>EventFilter</code> ，从而可以对日志消息，包括由于异常产生的日志，做断言:</p>
<pre><code class="lang-scala"><span class="hljs-keyword">import</span> akka.testkit.<span class="hljs-type">EventFilter</span>
<span class="hljs-keyword">import</span> com.typesafe.config.<span class="hljs-type">ConfigFactory</span>

<span class="hljs-keyword">implicit</span> <span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">system</span> =</span> <span class="hljs-type">ActorSystem</span>(<span class="hljs-string">"testsystem"</span>, <span class="hljs-type">ConfigFactory</span>.parseString(<span class="hljs-string">"""
  akka.loggers = ["akka.testkit.TestEventListener"]
  """</span>))
<span class="hljs-keyword">try</span> {
  <span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">actor</span> =</span> system.actorOf(<span class="hljs-type">Props</span>.empty)
  <span class="hljs-type">EventFilter</span>[<span class="hljs-type">ActorKilledException</span>](occurrences = <span class="hljs-number">1</span>) intercept {
    actor ! <span class="hljs-type">Kill</span>
  }
} <span class="hljs-keyword">finally</span> {
  shutdown(system)
}
</code></pre>
<p>如果出现的次数是具体的——如上所示——然后<code>intercept</code>将阻塞直到收到匹配消息达到这一数字，或<code>akka.test.filter-leeway</code>配置的超时时间用完了（在传入的代码块返回后，时间开始计数）。超时时测试失败。</p>
<blockquote>
<p>注意</p>
<p>一定要在你的 <code>application.conf</code>中替换默认的日志记录器为<code>TestEventListener</code>，以启用此功能：</p>
<pre><code>akka.loggers = [akka.testkit.TestEventListener]
</code></pre></blockquote>
<p><span id="testkit-within"></span></p>
<h5 id="">对定时进行断言</h5>
<p>功能测试的另一个重要部分与定时器有关：有些事件不能立即发生（如定时器），另外一些需要在时间期限内发生。因此所有的进行检查的方法 都接收一个时间上限，不论是正面还是负面的结果都应该在这个时间之前获得。时间下限需要在这个检测方法之外进行检查，因而有一个新的工具来管理时间期限:</p>
<pre><code class="lang-scala">   within([min, ]max) {
     ...
   }
</code></pre>
<p>传给<code>within</code>的代码块必须在一个介于 <code>min</code> 和 <code>max</code>之间的<code>Duration</code>之前完成，其中<code>min</code>缺省值为0。将<code>max</code> 参数与块的启动时间相加得到的时间期限在所有检查方法块内部都可以隐式获得，如果你没有指定<code>max</code>值，它会从最深层的 <code>within</code> 块继承这个值.</p>
<p>应注意如果代码块的最后一条接收消息断言是 <code>expectNoMsg</code> 或 <code>receiveWhile</code>，对 <code>within</code> 的最终检查将被跳过，以避免由于唤醒延迟导致的错误的true值。这意味着虽然其中每一个独立的断言仍然使用时间上限，整个代码块在这种情况下会有长度随机的延迟。</p>
<pre><code class="lang-scala"><span class="hljs-keyword">import</span> akka.actor.<span class="hljs-type">Props</span>
<span class="hljs-keyword">import</span> scala.concurrent.duration._

<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">worker</span> =</span> system.actorOf(<span class="hljs-type">Props</span>[<span class="hljs-type">Worker</span>])
within(<span class="hljs-number">200</span> millis) {
  worker ! <span class="hljs-string">"some work"</span>
  expectMsg(<span class="hljs-string">"some result"</span>)
  expectNoMsg <span class="hljs-comment">// will block for the rest of the 200ms</span>
  <span class="hljs-type">Thread</span>.sleep(<span class="hljs-number">300</span>) <span class="hljs-comment">// will NOT make this block fail</span>
}
</code></pre>
<blockquote>
<p>注意</p>
<p>所有的时间都以 <code>System.nanoTime</code>为单位，即它们描述的是墙上时间，而非CPU时间.</p>
</blockquote>
<p>Ray Roestenburg 写了一篇关于使用 TestKit 的<a href="http://roestenburg.agilesquad.com/2011/02/unit-testing-akka-actors-with-testkit_12.html" target="_blank">好文</a>。完整的示例也可以在<a href="09_1_testkit-example.html">这里</a>找到.</p>
<h6 id="">考虑很慢的测试系统</h6>
<p>你在跑得飞快的笔记本上使用的超时设置在高负载的Jenkins（或类似的）服务器上通常都会导致虚假的测试失败。 为了考虑这种情况，所有的时间上限都在内部乘以一个系数，这个系数来自<a href="../chapter2/09_configuration.html">配置文件</a>中的 <code>akka.test.timefactor</code>，缺省值为 1。</p>
<p>你也可以用<code>akka.testkit</code>包对象中的隐式转换来将同样的系数来作用于其它的时限，为<code>Duration</code>添加扩展函数。</p>
<pre><code class="lang-scala"><span class="hljs-keyword">import</span> scala.concurrent.duration._
<span class="hljs-keyword">import</span> akka.testkit._
<span class="hljs-number">10.</span>milliseconds.dilated
</code></pre>
<h5 id="actorref">用隐式的ActorRef解决冲突</h5>
<p>如果你希望在基于TestKit的测试中，消息发送者为 <code>testActor</code>，只需要在你的测试代码混入 <code>ÌmplicitSender</code>。</p>
<pre><code class="lang-scala"><span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">MySpec</span>(</span>_system: <span class="hljs-type">ActorSystem</span>) <span class="hljs-keyword">extends</span> <span class="hljs-type">TestKit</span>(_system) <span class="hljs-keyword">with</span> <span class="hljs-type">ImplicitSender</span>
  <span class="hljs-keyword">with</span> <span class="hljs-type">WordSpecLike</span> <span class="hljs-keyword">with</span> <span class="hljs-type">Matchers</span> <span class="hljs-keyword">with</span> <span class="hljs-type">BeforeAndAfterAll</span> {
</code></pre>
<h5 id="-actor">使用多个探针 Actor</h5>
<p>如果待测的actor会发送多个消息到不同的目标，在使用<code>TestKit</code>时可能会难以分辨到达 <code>testActor</code>的消息流。另一种方法是用它来创建简单的探针actor，将它们插入到消息流中。为了让这种方法更加强大和方便，我们提供了一个具体实现，称为 <code>TestProbe</code>。它的功能可以用下面的小例子说明：</p>
<pre><code class="lang-scala"><span class="hljs-keyword">import</span> scala.concurrent.duration._
<span class="hljs-keyword">import</span> akka.actor._
<span class="hljs-keyword">import</span> scala.concurrent.<span class="hljs-type">Future</span>

<span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">MyDoubleEcho</span> <span class="hljs-keyword"><span class="hljs-keyword">extends</span></span> <span class="hljs-title">Actor</span> {</span>
  <span class="hljs-keyword">var</span> dest1: <span class="hljs-type">ActorRef</span> = _
  <span class="hljs-keyword">var</span> dest2: <span class="hljs-type">ActorRef</span> = _
  <span class="hljs-function"><span class="hljs-keyword">def</span> <span class="hljs-title">receive</span> =</span> {
    <span class="hljs-keyword">case</span> (d1: <span class="hljs-type">ActorRef</span>, d2: <span class="hljs-type">ActorRef</span>) =&gt;
      dest1 = d1
      dest2 = d2
    <span class="hljs-keyword">case</span> x =&gt;
      dest1 ! x
      dest2 ! x
  }
}
</code></pre>
<pre><code class="lang-scala"><span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">probe1</span> =</span> <span class="hljs-type">TestProbe</span>()
<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">probe2</span> =</span> <span class="hljs-type">TestProbe</span>()
<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">actor</span> =</span> system.actorOf(<span class="hljs-type">Props</span>[<span class="hljs-type">MyDoubleEcho</span>])
actor ! ((probe1.ref, probe2.ref))
actor ! <span class="hljs-string">"hello"</span>
probe1.expectMsg(<span class="hljs-number">500</span> millis, <span class="hljs-string">"hello"</span>)
probe2.expectMsg(<span class="hljs-number">500</span> millis, <span class="hljs-string">"hello"</span>)
</code></pre>
<p>这里我们用 <code>MyDoubleEcho</code>来模拟一个待测系统，它会将输入镜像为两个输出。关联两个测试探针来进行（最简单）行为的确认。还有一个例子是两个相互协作的 actor A，B， A 发送消息给 B。为了确认这个消息流，可以插入一个 <code>TestProbe</code> 作为A的目标，使用转发功能或下文中的自动导向功能在测试上下文中包含一个真实的B。</p>
<p>还可以为探针配备自定义的断言来使测试代码更简洁清晰：</p>
<pre><code class="lang-scala">ase <span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">Update</span>(</span>id: <span class="hljs-type">Int</span>, value: <span class="hljs-type">String</span>)

<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">probe</span> =</span> <span class="hljs-keyword">new</span> <span class="hljs-type">TestProbe</span>(system) {
  <span class="hljs-function"><span class="hljs-keyword">def</span> <span class="hljs-title">expectUpdate</span>(</span>x: <span class="hljs-type">Int</span>) = {
    expectMsgPF() {
      <span class="hljs-keyword">case</span> <span class="hljs-type">Update</span>(id, _) <span class="hljs-keyword">if</span> id == x =&gt; <span class="hljs-literal">true</span>
    }
    sender() ! <span class="hljs-string">"ACK"</span>
  }
}
</code></pre>
<p>这里你拥有完全的灵活性，可以将<code>TestKit</code> 提供的工具与你自己的检测代码混合和匹配，并为它取一个有意义的名字。在实际开发中你的代码很可能比上面的示例要复杂；要充分利用工具的力量！</p>
<blockquote>
<p>警告</p>
<p>任何从 <code>TestProbe</code>发送到另一个运行在 <code>CallingThreadDispatcher</code>上的actor的消息，如果另一个actor也可能会向此探测器发送消息，则存在死锁的可能性。<code>TestProbe.watch</code>和<code>TestProbe.unwatch</code>的实现也将向监控者发送消息，这意味着尝试监视它是危险的，例如从<code>TestProbe</code>监视<code>TestActorRef</code>。</p>
</blockquote>
<h5 id="actor">从探针观察其它actor</h5>
<p><code>TestProbe</code>可以将自己注册为任意其他actor的DeathWatch：</p>
<pre><code class="lang-scala"><span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">probe</span> =</span> <span class="hljs-type">TestProbe</span>()
probe watch target
target ! <span class="hljs-type">PoisonPill</span>
probe.expectTerminated(target)
</code></pre>
<h5 id="">对探针收到的消息进行应答</h5>
<p>探针在可能的条件下，会记录通讯通道以便进行应答：</p>
<pre><code class="lang-scala"><span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">probe</span> =</span> <span class="hljs-type">TestProbe</span>()
<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">future</span> =</span> probe.ref ? <span class="hljs-string">"hello"</span>
probe.expectMsg(<span class="hljs-number">0</span> millis, <span class="hljs-string">"hello"</span>) <span class="hljs-comment">// TestActor runs on CallingThreadDispatcher</span>
probe.reply(<span class="hljs-string">"world"</span>)
assert(future.isCompleted &amp;&amp; future.value == <span class="hljs-type">Some</span>(<span class="hljs-type">Success</span>(<span class="hljs-string">"world"</span>)))
</code></pre>
<h5 id="">对探针收到的消息进行转发</h5>
<p>假定一个象征性的actor网络中某目标 actor <code>dest</code> 从 actor <code>source</code>收到一条消息。如果你安排消息使其先发往 <code>TestProbe</code> <code>probe</code>，你可以在保持网络功能的同时对消息流的容量和时限进行断言：</p>
<pre><code class="lang-scala"><span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">Source</span>(</span>target: <span class="hljs-type">ActorRef</span>) <span class="hljs-keyword">extends</span> <span class="hljs-type">Actor</span> {
  <span class="hljs-function"><span class="hljs-keyword">def</span> <span class="hljs-title">receive</span> =</span> {
    <span class="hljs-keyword">case</span> <span class="hljs-string">"start"</span> =&gt; target ! <span class="hljs-string">"work"</span>
  }
}

<span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">Destination</span> <span class="hljs-keyword"><span class="hljs-keyword">extends</span></span> <span class="hljs-title">Actor</span> {</span>
  <span class="hljs-function"><span class="hljs-keyword">def</span> <span class="hljs-title">receive</span> =</span> {
    <span class="hljs-keyword">case</span> x =&gt; <span class="hljs-comment">// Do something..</span>
  }
}
</code></pre>
<pre><code class="lang-scala"><span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">probe</span> =</span> <span class="hljs-type">TestProbe</span>()
<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">source</span> =</span> system.actorOf(<span class="hljs-type">Props</span>(classOf[<span class="hljs-type">Source</span>], probe.ref))
<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">dest</span> =</span> system.actorOf(<span class="hljs-type">Props</span>[<span class="hljs-type">Destination</span>])
source ! <span class="hljs-string">"start"</span>
probe.expectMsg(<span class="hljs-string">"work"</span>)
probe.forward(dest)
</code></pre>
<p>目标<code>dest</code> actor 将收到同样的消息，就象没有插入探针一样。</p>
<h5 id="">自动导向</h5>
<p>将收到的消息放进队列以便以后处理，这种方法不错，但要保持测试运行并对其运行过程进行跟踪，你也可以为参与测试的探针（事实上是任何 <code>TestKit</code>）安装一个 <code>AutoPilot</code>（自动导向）。自动导向在消息进入检查队列之前启动。以下代码可以用来转发消息，例如 <code>A --&gt; Probe --&gt; B</code>，只要满足一定的协议。</p>
<pre><code class="lang-scala"><span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">probe</span> =</span> <span class="hljs-type">TestProbe</span>()
probe.setAutoPilot(<span class="hljs-keyword">new</span> <span class="hljs-type">TestActor</span>.<span class="hljs-type">AutoPilot</span> {
  <span class="hljs-function"><span class="hljs-keyword">def</span> <span class="hljs-title">run</span>(</span>sender: <span class="hljs-type">ActorRef</span>, msg: <span class="hljs-type">Any</span>): <span class="hljs-type">Option</span>[<span class="hljs-type">TestActor</span>.<span class="hljs-type">AutoPilot</span>] =
    msg <span class="hljs-keyword">match</span> {
      <span class="hljs-keyword">case</span> <span class="hljs-string">"stop"</span> ⇒ <span class="hljs-type">None</span>
      <span class="hljs-keyword">case</span> x      ⇒ testActor.tell(x, sender); <span class="hljs-type">Some</span>(<span class="hljs-keyword">this</span>)
    }
})
</code></pre>
<p><code>run</code> 方法必须返回<code>auto-pilot</code>供下一条消息使用，它可以是<code>KeepRunning</code>来保存当前值，或者是<code>NoAutoPilot</code>来终止自动导向。</p>
<h5 id="">小心定时器断言</h5>
<p>在使用测试探针时，<code>within</code>块的行为可能会不那么直观：你需要记住<a href="#testkit-within">上文</a> 所描述的nicely scoped期限仅对每一个探针的局部作用域有效。因此，探针不会响应别的探针的期限，也不响应包含它的<code>TestKit</code>实例的期限：</p>
<pre><code class="lang-scala"><span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">probe</span> =</span> <span class="hljs-type">TestProbe</span>()
within(<span class="hljs-number">1</span> second) {
  probe.expectMsg(<span class="hljs-string">"hello"</span>)
}
</code></pre>
<p>这里<code>expectMsg</code>调用将使用默认超时。</p>
<p><span id="scala-callingthreaddispatcher"></span></p>
<h3 id="callingthreaddispatcher">CallingThreadDispatcher</h3>
<p>如上文所述，<code>CallingThreadDispatcher</code>在单元测试中非常重要，但最初它出现是为了在出错的时候能够生成连续的stacktrace。由于这个特殊的派发器一般地将任何消息直接运行在当前线程中，所以只要所有的actor都是在这个派发器上运行，消息处理的完整历史信息在调用堆栈上就有记录。</p>
<h5 id="">如何使用它</h5>
<p>只要象平常一样设置派发器：</p>
<pre><code class="lang-scala"><span class="hljs-keyword">import</span> akka.testkit.<span class="hljs-type">CallingThreadDispatcher</span>
<span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">ref</span> =</span> system.actorOf(<span class="hljs-type">Props</span>[<span class="hljs-type">MyActor</span>].withDispatcher(<span class="hljs-type">CallingThreadDispatcher</span>.<span class="hljs-type">Id</span>))
</code></pre>
<h5 id="">它是如何运作的</h5>
<p>在被调用时，<code>CallingThreadDispatcher</code> 会检查接收消息的actor是否已经在当前线程中了。这种情况的最简单的例子是actor向自己发送消息。这时，不能马上对它进行处理，因为这违背了actor模型，于是这个消息被放进队列，直到actor的当前消息被处理完毕；因此，新消息会在调用的线程上被处理，只是在actor完成其先前的工作之后。在别的情况下，消息会在当前线程中立即得到处理。通过这个派发器规划的Future也会立即执行。</p>
<p>这种工作方式使 <code>CallingThreadDispatcher</code> 象一个为永远不会因为外部事件而阻塞的actor所设计的通用派发器。</p>
<p>在有多个线程的情况下，有可能同时存在两个使用这个派发器的actor在不同线程中收到消息。此时，它们会立即在自己的线程中被执行，并竞争actor锁，竞争失败的那个必须等待。 这样我们保持了actor模型，但由于使用了受限的调度我们损失了一些并发性。从这个意义上说，它等同于使用传统的基于互斥的并发。</p>
<p>另一个困难是正确地处理挂起和继续：当actor被挂起时，后续的消息将被放进一个thread-local的队列中（和正常情况下使用的队列是同一个)。但是对 <code>resume</code>的调用，是由一个特定的线程执行的，系统中所有其它的线程很可能不会运行这个特定的actor，这会导致thread-local队列无法被它们的本地线程清空。于是，调用 <code>resume</code> 的线程会从所有线程收集所有当前在队列中的消息到自己的队列中，然后处理它们。</p>
<h5 id="">局限性</h5>
<blockquote>
<p>警告</p>
<p>在<code>CallingThreadDispatcher</code>被用作顶级actor，但没有通过<code>TestActorRef</code>的情况下，则存在一个时间窗，在此期间actor会等待user 守护者actor的构造。在此期间发送到这个actor的消息会被加入队列，然后在守护者的线程，而不是调用者的线程上执行。要避免此问题，请使用 <code>TestActorRef</code>。</p>
</blockquote>
<p>如果一个actor发送完消息后由于某种原因（通常是被发完消息后的调用actor所影响）阻塞了，此时若使用这个派发器，显然将导致死锁。 这在使用基于 <code>CountDownLatch</code> 同步actor测试中是很常见的情景：</p>
<pre><code class="lang-scala">   <span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">latch</span> =</span> <span class="hljs-keyword">new</span> <span class="hljs-type">CountDownLatch</span>(<span class="hljs-number">1</span>)
   actor ! startWorkAfter(latch)   <span class="hljs-comment">// actor will call latch.await() before proceeding</span>
   doSomeSetupStuff()
   latch.countDown()
</code></pre>
<p>这个例子将无限挂起，消息处理到达第二行而永远到不了第四行，而只有在第四行才能在一个普通的派发器上取消它的阻塞。</p>
<p>所以要记住 <code>CallingThreadDispatcher</code>并不是普通派发器的通用替代品。而另一方面在它上面运行你的actor网络测试会非常有用，因为如果它在机率特别高的条件下都能不死锁，那么在生产环境中也不会。</p>
<blockquote>
<p>警告</p>
<p>上面这句话很遗憾并不是一个有力的保证，因为你的代码运行在不同的派发器上时可能直接或间接地改变它的行为。 如果你想要寻找帮助你debug死锁的工具，<code>CallingThreadDispatcher</code> 在有些错误场合下可能会有用，但要记住它既可能给出错误的正面结果也可能给出错误的负面结果。</p>
</blockquote>
<h5 id="">线程中断</h5>
<p>如果 <code>CallingThreadDispatcher</code>看到当前线程在消息处理返回时已设置其 <code>isInterrupted()</code> 标志，它将在完成所有其处理（即，如上文所述的需要处理的所有消息，都会在这种情况发生之前处理）后抛出<code>InterruptedException</code>异常。正如<code>tell</code>由于其契约不能抛出异常，该异常将然后被捕获并记录日志，并且在该线程中断状态将再次设置。</p>
<p>如果在消息处理过程中抛出<code>InterruptedException</code>异常，则它将被<code>CallingThreadDispatcher</code> 的消息处理循环捕获，然后将设置该线程<code>interrupted</code>标志，并且处理将继续正常进行。</p>
<blockquote>
<p>注意</p>
<p>这两个段落的总结是，如果当前线程在<code>CallingThreadDispatcher</code>下工作时中断，则将导致当消息发送返回时 <code>isInterrupted</code>标志被置为<code>true</code>，并不抛出<code>InterruptedException</code>异常。</p>
</blockquote>
<h5 id="">好处</h5>
<p>综上所述，以下是 <code>CallingThreadDispatcher</code>能够提供的特性：</p>
<ul>
<li>确定地执行单线程测试，同时保持几乎所有的actor语义</li>
<li>在异常stacktrace中记录从失败点开始的完整的消息处理历史</li>
<li>排除某些类型的死锁场景</li>
</ul>
<h3 id="a-nameactor-logging-scalaaactor"><a name="actor-logging-scala"></a>跟踪Actor调用</h3>
<p>到目前为止所有的测试工具都针对系统的行为构造断言。如果测试失败，通常是由你来查找原因，进行修改并进行下一轮验证测试。这个过程既有debugger支持，又有日志支持，这里Akka工具箱提供以下选项:</p>
<ul>
<li><p><em>对Actor实例中抛出的异常记录日志</em></p>
<p>相比其它的日志机制，这一条是永远打开的；它的日志级别是 <code>ERROR</code>.</p>
</li>
<li><p><em>对某些actor的消息调用记录日志</em></p>
<p>这是通过在<a href="../chapter2/09_configuration.html">配置文件</a>里添加设置项来打开 — 即 <code>akka.actor.debug.receive</code> — 它使得 <code>loggable</code>语句被应用在actor的 <code>receive</code> 函数上:</p>
</li>
</ul>
<pre><code class="lang-scala"><span class="hljs-keyword">import</span> akka.event.<span class="hljs-type">LoggingReceive</span>
<span class="hljs-function"><span class="hljs-keyword">def</span> <span class="hljs-title">receive</span> =</span> <span class="hljs-type">LoggingReceive</span> {
  <span class="hljs-keyword">case</span> msg =&gt; <span class="hljs-comment">// Do something ...</span>
}
<span class="hljs-function"><span class="hljs-keyword">def</span> <span class="hljs-title">otherState</span>:</span> <span class="hljs-type">Receive</span> = <span class="hljs-type">LoggingReceive</span>.withLabel(<span class="hljs-string">"other"</span>) {
  <span class="hljs-keyword">case</span> msg =&gt; <span class="hljs-comment">// Do something else ...</span>
}
</code></pre>
<p>如果在<a href="../chapter2/09_configuration.html">配置文件</a>中没有上面给出的配置，这个方法将直接移交给给定的未被修改的 <code>Receive</code> 函数，也就是说如果不打开，就没有运行时开销。</p>
<p>这个日志功能是与指定的局部标记绑定的，因为将其一致地应用于所有的actor一般不是你所需要的，如果被用于事件主线日志监听器，它还可能导致无限循环。</p>
<ul>
<li><em>对特殊的消息记录日志</em></li>
</ul>
<p>Actor会自动处理某些特殊消息,例如<code>Kill</code>，<code>PoisonPill</code> 等等。打开对这些消息的跟踪只需要设置 <code>akka.actor.debug.autoreceive</code>，这对所有actor都有效。</p>
<ul>
<li><em>对actor生命周期记录日志</em></li>
</ul>
<p>Actor的创建、启动、重启、开始监控、停止监控和终止可以通过打开 <code>akka.actor.debug.lifecycle</code> 来跟踪；这也是对所有actor都有效的。</p>
<p>所有这些日志消息都记录在 <code>DEBUG</code> 级别。总结一下，你可以用以下配置片段打开actor活动的完整日志：</p>
<pre><code>akka {
  loglevel = DEBUG
  actor {
    debug {
      receive = on
      autoreceive = on
      lifecycle = on
    }
  }
}
</code></pre><h3 id="">不同的测试框架</h3>
<p>Akka的测试套件是使用<a href="http://scalatest.org" target="_blank">ScalaTest</a>，并参照文档中的示例编写的。然而，TestKit和其工具包并不依赖于这一框架，实际上你可以使用最适合你开发风格的测试框架。</p>
<p>本节包含使用其他框架时的已知陷阱，这不是详尽的，并不意味着需要认证或使用特殊支持。</p>
<h5 id="">当你需要它是一个特质</h5>
<p>如果由于某种原因是，<code>TestKit</code>是一个具体的类，而不是特质，因此测试工具无法继承它，还有<code>TestKitBase</code>：</p>
<pre><code class="lang-scala"><span class="hljs-keyword">import</span> akka.testkit.<span class="hljs-type">TestKitBase</span>

<span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">MyTest</span> <span class="hljs-keyword"><span class="hljs-keyword">extends</span></span> <span class="hljs-title">TestKitBase</span> {</span>
  <span class="hljs-keyword">implicit</span> <span class="hljs-keyword">lazy</span> <span class="hljs-function"><span class="hljs-keyword">val</span> <span class="hljs-title">system</span> =</span> <span class="hljs-type">ActorSystem</span>()

  <span class="hljs-comment">// put your test code here ...</span>

  shutdown(system)
}
</code></pre>
<p><code>implicit lazy val system</code>必须这样声明 （你当然可以根据需要将参数传递到actor系统工厂中） 因为特质 <code>TestKitBase</code> 在其构造过程中需要system。</p>
<blockquote>
<p>警告</p>
<p>不提倡使用这个特质，由于在未来二进制向后兼容性可能会成为问题，所以使用它须自行承担风险。</p>
</blockquote>
<h5 id="specs2">Specs2</h5>
<p>一些 <a href="http://specs2.org" target="_blank"><code>Specs2</code></a>用户贡献了如何变通解决可能出现的一些冲突的示例：</p>
<ul>
<li><p>在TestKit中混入 <code>org.specs2.mutable.Specification</code> 将导致涉及 <code>end</code> 方法的名称冲突 （它在TestKit中是私有变量，而在Specification中是抽象方法）；如果第一次混入测试工具包，代码可以编译，但可能在运行时失败。变通方法——实际上也有利于第三点—— 是将<code>org.specs2.specification.Scope</code>和TestKit一起应用。</p>
</li>
<li><p>Specification特质提供了一个<code>Duration</code> DSL 的部分，使用了与<code>scala.concurrent.duration.Duration</code>具有相同名称的方法，如果引入<code>scala.concurrent.duration._</code>会导致含糊不清的隐式值。有两个变通：</p>
<ul>
<li>要么使用Specification的Duration变体，提供到Akka Duration的隐式转换。这种转换不由Akka提供，因为这将意味着我们的 JAR 文件将依赖于 Specs2，为实现这样一个小特性不合理。</li>
<li>或混入<code>org.specs2.time.NoTimeConversions</code>到Specification中。</li>
</ul>
</li>
<li><p>Specifications默认是并发执行的，因此执行写入测试或者<code>sequential</code>关键字时需要谨慎一些。</p>
</li>
</ul>
<h3 id="">配置</h3>
<p>TestKit模块的几个配置属性，请参阅<a href="../chapter2/09_configuration.html">配置参考</a>。</p>

                    
                    </section>
                
                
                </div>
            </div>
        </div>

        
        <a href="../chapter3/08_persistence.html" class="navigation navigation-prev " aria-label="Previous page: 持久化"><i class="fa fa-angle-left"></i></a>
        
        
        <a href="../chapter3/09_1_testkit-example.html" class="navigation navigation-next " aria-label="Next page: TestKit实例"><i class="fa fa-angle-right"></i></a>
        
    </div>
</div>

        
<script src="../gitbook/app.js"></script>

    
    <script src="https://cdn.mathjax.org/mathjax/2.4-latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
    

    
    <script src="../gitbook/plugins/gitbook-plugin-mathjax/plugin.js"></script>
    

<script>
require(["gitbook"], function(gitbook) {
    var config = {"fontSettings":{"theme":null,"family":"sans","size":2}};
    gitbook.start(config);
});
</script>

        
    </body>
    
</html>
